home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / standard / ldtbread.z / ldtbread
Encoding:
Text File  |  2002-10-03  |  2.5 KB  |  55 lines
  1. LDTBREAD(3X)                                          Last changed: 11-5-98
  2.  
  3.  
  4. NNAAMMEE
  5.      llddttbbrreeaadd - Reads an indexed symbol table entry of a common object file
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddiioo..hh>>
  9.      ##iinncclluuddee <<ffiilleehhddrr..hh>>
  10.      ##iinncclluuddee <<ssyymmss..hh>>
  11.      ##iinncclluuddee <<llddffccnn..hh>>
  12.  
  13.      iinntt llddttbbrreeaadd (("_l_d_p_t_r,_s_y_m_i_n_d_e_x,_s_y_m_b_o_l"))
  14.      LLDDFFIILLEE **_l_d_p_t_r;;
  15.      lloonngg _s_y_m_i_n_d_e_x;;
  16.      ppSSYYMMRR _s_y_m_b_o_l;;
  17.  
  18. IIMMPPLLEEMMEENNTTAATTIIOONN
  19.      IRIX systems (o32 ABI only)
  20.  
  21. DDEESSCCRRIIPPTTIIOONN
  22.      llddttbbrreeaadd reads the symbol table entry specified by _s_y_m_i_n_d_e_x of the
  23.      common object file currently associated with _l_d_p_t_r into the area of
  24.      memory beginning at _s_y_m_b_o_l.
  25.  
  26.      llddttbbrreeaadd returns SSUUCCCCEESSSS or FFAAIILLUURREE.  If _s_y_m_i_n_d_e_x is greater than the
  27.      number of symbols in the object file, or if it cannot read the
  28.      specified symbol table entry, llddttbbrreeaadd fails.
  29.  
  30.      The local and external symbols are concatenated into a linear list.
  31.      Symbols are accessible from symnum zero to
  32.      SSYYMMHHEEAADDEERR((llddppttrr))..iissyymmMMaaxx++SSYYMMHHEEAADDEERR((llddppttrr))..iieexxttMMaaxx.. The index and iss
  33.      fields of the SYMR are made absolute (rather than file relative) so
  34.      that routines llddggeettnnaammee(3X), llddggeettaauuxx(3X), and llddttbbrreeaadd (this routine)
  35.      proceed normally given those indices.  Only the ssyymm part of externals
  36.      is returned.
  37.  
  38.      The first symbol in the symbol table has an index of zzeerroo.
  39.  
  40.      The program must allocate space big enough for a SSYYMMRR and point the
  41.      ppSSYYMMRR argument at the space before calling llddttbbrreeaadd.
  42.  
  43.      The program must be loaded with the object file access routine library
  44.      lliibbmmlldd..aa.
  45.  
  46.      iinnttrroo(5) describes IINNCCDDIIRR and LLIIBBDDIIRR.
  47.  
  48. SSEEEE AALLSSOO
  49.      llddcclloossee(3X), llddggeettnnaammee(3X), llddooppeenn(3X), llddttbbsseeeekk(3X)
  50.  
  51.      iinnttrroo(4), llddffccnn(4)
  52.  
  53.      This man page is available only online.
  54.  
  55.